home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glnewlist.z / glnewlist
Encoding:
Text File  |  2001-04-17  |  11.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllNNNNeeeewwwwLLLLiiiisssstttt,,,, ggggllllEEEEnnnnddddLLLLiiiisssstttt - create or replace a display list
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllNNNNeeeewwwwLLLLiiiisssstttt( GLuint _l_i_s_t,
  14.                      GLenum _m_o_d_e )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _l_i_s_t  Specifies the display-list name.
  19.  
  20.      _m_o_d_e  Specifies the compilation mode, which can be GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE or
  21.            GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE____AAAANNNNDDDD____EEEEXXXXEEEECCCCUUUUTTTTEEEE.
  22.  
  23. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  24.      void ggggllllEEEEnnnnddddLLLLiiiisssstttt( void )
  25.  
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      Display lists are groups of GL commands that have been stored for
  29.      subsequent execution.  Display lists are created with ggggllllNNNNeeeewwwwLLLLiiiisssstttt.  All
  30.      subsequent commands are placed in the display list, in the order issued,
  31.      until ggggllllEEEEnnnnddddLLLLiiiisssstttt is called.
  32.  
  33.      ggggllllNNNNeeeewwwwLLLLiiiisssstttt has two arguments.  The first argument, _l_i_s_t, is a positive
  34.      integer that becomes the unique name for the display list.  Names can be
  35.      created and reserved with ggggllllGGGGeeeennnnLLLLiiiissssttttssss and tested for uniqueness with
  36.      ggggllllIIIIssssLLLLiiiisssstttt.  The second argument, _m_o_d_e, is a symbolic constant that can
  37.      assume one of two values:
  38.  
  39.      GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE                    Commands are merely compiled.
  40.  
  41.      GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE____AAAANNNNDDDD____EEEEXXXXEEEECCCCUUUUTTTTEEEE        Commands are executed as they are compiled
  42.                                    into the display list.
  43.  
  44.      Certain commands are not compiled into the display list but are executed
  45.      immediately, regardless of the display-list mode.  These commands are
  46.      ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnntttt, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ggggllllDDDDeeeelllleeeetttteeeeLLLLiiiissssttttssss, ggggllllDDDDeeeelllleeeetttteeeeTTTTeeeexxxxttttuuuurrrreeeessss,
  47.      ggggllllDDDDiiiissssaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee, ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee,
  48.      ggggllllFFFFeeeeeeeeddddbbbbaaaacccckkkkBBBBuuuuffffffffeeeerrrr, ggggllllFFFFiiiinnnniiiisssshhhh, ggggllllFFFFlllluuuusssshhhh, ggggllllGGGGeeeennnnLLLLiiiissssttttssss, ggggllllGGGGeeeennnnTTTTeeeexxxxttttuuuurrrreeeessss,
  49.      ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr, ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss, ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd, ggggllllIIIIssssLLLLiiiisssstttt, ggggllllIIIIssssTTTTeeeexxxxttttuuuurrrreeee,
  50.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb,
  51.      ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ggggllllRRRReeeennnnddddeeeerrrrMMMMooooddddeeee, ggggllllSSSSeeeelllleeeeccccttttBBBBuuuuffffffffeeeerrrr, ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr,
  52.      ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr, and all of the ggggllllGGGGeeeetttt commands.
  53.  
  54.      Similarly, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, and ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD are executed
  55.      immediately and not compiled into the display list when their first
  56.      argument is GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, or
  57.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD, respectively.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      When the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, ggggllllHHHHiiiissssttttooooggggrrrraaaammmm executes
  75.      immediately when its argument is GGGGLLLL____PPPPRRRROOOOXXXXYYYY____HHHHIIIISSSSTTTTOOOOGGGGRRRRAAAAMMMM.  Similarly,
  76.      ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee executes immediately when its first argument is
  77.      ggggllllPPPPRRRROOOOXXXXYYYY____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, ggggllllPPPPRRRROOOOXXXXYYYY____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, or
  78.      ggggllllPPPPRRRROOOOXXXXYYYY____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE.
  79.  
  80.      When ggggllllEEEEnnnnddddLLLLiiiisssstttt is encountered, the display-list definition is completed
  81.      by associating the list with the unique name _l_i_s_t (specified in the
  82.      ggggllllNNNNeeeewwwwLLLLiiiisssstttt command). If a display list with name _l_i_s_t already exists, it
  83.      is replaced only when ggggllllEEEEnnnnddddLLLLiiiisssstttt is called.
  84.  
  85. NNNNOOOOTTTTEEEESSSS
  86.      ggggllllCCCCaaaallllllllLLLLiiiisssstttt and ggggllllCCCCaaaallllllllLLLLiiiissssttttssss can be entered into display lists.  Commands
  87.      in the display list or lists executed by ggggllllCCCCaaaallllllllLLLLiiiisssstttt or ggggllllCCCCaaaallllllllLLLLiiiissssttttssss are
  88.      not included in the display list being created, even if the list creation
  89.      mode is GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE____AAAANNNNDDDD____EEEEXXXXEEEECCCCUUUUTTTTEEEE.
  90.  
  91.      A display list is just a group of commands and arguments, so errors
  92.      generated by commands in a display list must be generated when the list
  93.      is executed. If the list is created in GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE mode, errors are not
  94.      generated until the list is executed.
  95.  
  96. EEEERRRRRRRROOOORRRRSSSS
  97.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_i_s_t is 0.
  98.  
  99.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  100.  
  101.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllEEEEnnnnddddLLLLiiiisssstttt is called without a
  102.      preceding ggggllllNNNNeeeewwwwLLLLiiiisssstttt, or if ggggllllNNNNeeeewwwwLLLLiiiisssstttt is called while a display list is
  103.      being defined.
  104.  
  105.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllNNNNeeeewwwwLLLLiiiisssstttt or ggggllllEEEEnnnnddddLLLLiiiisssstttt is executed
  106.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  107.      ggggllllEEEEnnnndddd.
  108.  
  109.      GGGGLLLL____OOOOUUUUTTTT____OOOOFFFF____MMMMEEEEMMMMOOOORRRRYYYY is generated if there is insufficient memory to compile
  110.      the display list. If the GL version is 1.1 or greater, no change is made
  111.      to the previous contents of the display list, if any, and no other change
  112.      is made to the GL state. (It is as if no attempt had been made to create
  113.      the new display list.)
  114.  
  115. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  116.      ggggllllIIIIssssLLLLiiiisssstttt
  117.      ggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIISSSSTTTT____IIIINNNNDDDDEEEEXXXX
  118.      ggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIISSSSTTTT____MMMMOOOODDDDEEEE
  119.  
  120.  
  121. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.      ggggllllCCCCaaaallllllllLLLLiiiisssstttt, ggggllllCCCCaaaallllllllLLLLiiiissssttttssss, ggggllllDDDDeeeelllleeeetttteeeeLLLLiiiissssttttssss, ggggllllGGGGeeeennnnLLLLiiiissssttttssss
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.